| Description | : The `Get Hourly Forecast` API is an HTTP `GET` that Request detailed weather forecast by the hour for the next 1, 12, 24 (1 day), 72 (3 days), 120 (5 days), and 240 hours (10 days) for the given the given coordinate location. The API returns details such as temperature, humidity, wind, precipitation, and ultraviolet (UV) index. For more information, see [Request hourly weather forecast data](/azure/azure-maps/how-to-request-weather-data#request-hourly-weather-forecast-data). If you are using the Gen1 S0 pricing tier, you can request hourly forecast for the next 1, 12, 24 hours (1 day), and 72 hours (3 days). If you are using Gen1 S1 or Gen2 pricing tier, you can also request hourly forecast for the next 120 (5 days) and 240 hours (10 days). |
| Reference | : Link ¶ |
⚶ Changes
{
"#id": "Weather_GetHourlyForecast",
"$responses": {
"200": {
"$properties": {
"forecasts": {
"$properties": [
{
"#name": "date",
"Description": {
"new": "Date and time of the forecast in [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) format, for example, 2019-10-27T19:39:57-08:00.",
"old": "Date and time of the forecast in ISO 8601 format, for example, 2019-10-27T19:39:57-08:00."
}
},
{
"#name": "hasPrecipitation",
"Description": {
"new": "A boolean value that indicates whether precipitation (rain, snow, sleet, or hail) is expected during the specified timeframe. Returns true if precipitation is expected, otherwise false.",
"old": "Indicates the presence or absence of precipitation. True indicates the presence of precipitation, false indicates the absence of precipitation."
}
}
]
}
}
}
}
}
⚼ Request
GET:
/weather/forecast/hourly/{format}
{
x-ms-client-id:
string
,
api-version:
string
,
format:
string
,
query:
array
,
unit:
string
,
duration:
integer
,
language:
string
,
}
⚐ Response (200)
{
forecasts:
}
[
]
,
{
,
date:
string
,
iconCode:
integer
,
iconPhrase:
string
,
hasPrecipitation:
boolean
,
isDaylight:
boolean
,
temperature:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
realFeelTemperature:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
wetBulbTemperature:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
dewPoint:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
wind:
{
,
direction:
{
,
degrees:
integer
,
localizedDescription:
string
,
}
speed:
}
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
windGust:
{
,
direction:
{
,
degrees:
integer
,
localizedDescription:
string
,
}
speed:
}
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
relativeHumidity:
integer
,
visibility:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
ceiling:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
uvIndex:
integer
,
uvIndexPhrase:
string
,
precipitationProbability:
integer
,
rainProbability:
integer
,
snowProbability:
integer
,
iceProbability:
integer
,
totalLiquid:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
rain:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
snow:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
ice:
{
,
value:
number
,
unit:
string
,
unitType:
integer
,
}
cloudCover:
integer
,
}
⚐ Response (default)
{
error:
}
{
,
code:
string
,
message:
string
,
target:
string
,
details:
[
,
string
,
]
additionalInfo:
}
[
]
,
{
,
type:
string
,
info:
object
,
}